home *** CD-ROM | disk | FTP | other *** search
/ Video Toaster 4.0 / Video Toaster v4.0.iso / programs / documentation / toast100.doc < prev    next >
Text File  |  1993-12-13  |  4KB  |  119 lines
  1.       Toast100    By Arnie Cachelin © 1993 NewTek Inc.
  2. Thu Jun  3 01:10:42 1993
  3.  
  4.  
  5.   Toast100 is a the Grass Valley 100 protocol emulator for the Video Toaster.
  6. It is based on the Grass Valley Group document:  ---???.
  7. Although the Video Toaster's functions do not match those of the GVG100
  8. switcher, the basic transition and switching functions have been
  9. implemented as fully as possible.
  10.  
  11. Hardware Requirements
  12.  
  13.   The Grass Valley 100 switcher uses an RS-422 serial communications protocol.
  14. The Toaster's serial port is only RS-232C.  If your editor uses RS-422 only
  15. you will need a converter.  Conversion boxes and cables are generally available
  16. from computer or electronics suppliers.  If you have an editor
  17. which speaks RS-232, you can connect it with only a 'null modem' adapter.
  18.  
  19.  
  20. Operation
  21.  
  22.   Toast100 currently runs either from the AmigaDOS Command Shell (CLI), or
  23. from the Workbench graphical interface.  If it is run without any
  24. arguments, it will start in the default mode: using the internal serial
  25. port and software at 38.4kbaud, 8 bits, Odd parity, 1 stop bit (38400 8O1).
  26. To use a different serial port, different communications settings, or a
  27. different device address specify them on the Toast100 command line or in
  28. the workbench icon tooltypes.  The [optional] command line parameters will
  29. be displayed if the program is run with the argument "-?".  They are
  30. -b<BAUD> -s<SETTINGS> -d<DEVICE> -u<UNIT> -a<ADDRESS>.  For example, the
  31. default settings would be set by running Toast100 as follows:
  32.     Toast100 -b38400 -s8O1 -dSerial.device -u0 -a30
  33. The supported tooltypes are similar, use BAUD=<baud>, SETTINGS=<settings>,
  34. DEVICE=<Device>, UNIT=<unit>, ADDRESS=<address>.
  35.  
  36.   Toast100 does not currently require that the Toaster software be running
  37. for it to execute, but all its attempted commands to the Toaster will
  38. return the rather emphatic message "NO TOASTER!", and send it out the
  39. serial port.  If the Toaster is running, the commands will be executed as
  40. they are received.  If commands are sent while the Toaster is busy, they
  41. will pile up and be handled in turn.  You can quit Toast100 by clicking the
  42. Close button in the upper-left corner of the little window it opens on your
  43. Workbench screen.  Toast100 will also exit if the mystical command 0x35 is
  44. received.  This must be in command form (i.e.[BYTECOUNT][FX_ADDRESS][0x35]).
  45. The default device address is 0x30, and Toast100 will respond to the
  46. correct device address with an ACK.  Any other byte will be interpreted as
  47. a byte count (if it is between 2 and 6) or a wrong address, which will
  48. elicit a NAK.  Presently the FX ADDRESS BYTE is ignored and may have any
  49. value.
  50.  
  51. Protocol Implementation
  52.  
  53.   Toast100 supports Program, Preview, and Key bus crosspoints for all the
  54. Toaster's live sources, the 2 still stores, and 9 background generator
  55. colors, in that order.  Crosspoint 0 goes to the black background.  The
  56. following is a table of implemented command codes:
  57.  
  58.   0x41  Read Program bus
  59.   0x42  Read Preview bus
  60.   0x43  Read Overlay (Key) bus
  61.   0x44  Read Overlay (Key) bus
  62.   0x45  Read analog control (0=Clip, 1=TBar, 2=Border preset)
  63.   0x46  Read push button lamp (on the Toaster?? )
  64.   0x47  Read push button lamp (on the Toaster?? )
  65.   0x4C  Read Transition frame rate
  66.   0x7D  Read Transition frame rate
  67.   0x6C  Read version
  68.   0xC1  Set Program bus
  69.   0xC2  Set Preview bus
  70.   0xC4  Set Overlay (Key) bus
  71.   0xC3  Set Overlay (Key) bus
  72.   0xC5  Set analog control (0=Clip, 1=TBar, 2=Border preset)
  73.   0xC6  Set push button lamp
  74.   0xC7  Set push button lamp
  75.   0xC8  Set Transition
  76.   0xCC  Set Transition frame rate
  77.   0xFD  Set Transition frame rate
  78.   0x0B  Set Auto trans (i.e. do it)
  79.  
  80. Push button Lamps:
  81.   PRG0      0x00
  82.   PRG1      0x01
  83.   PRG2      0x02
  84.   PRG3      0x03
  85.   PRG4      0x04
  86.   PRG5      0x05
  87.   PRG6      0x06
  88.   PRG7      0x07
  89.   PRG8      0x08
  90.   PRG9      0x09
  91.   PRV0      0x10
  92.   PRV1      0x11
  93.   PRV2      0x12
  94.   PRV3      0x13
  95.   PRV4      0x14
  96.   PRV5      0x15
  97.   PRV6      0x16
  98.   PRV7      0x17
  99.   PRV8      0x18
  100.   PRV9      0x19
  101.   KEY0      0x20
  102.   KEY1      0x21
  103.   KEY2      0x22
  104.   KEY3      0x23
  105.   KEY4      0x24
  106.   KEY5      0x25
  107.   KEY6      0x26
  108.   KEY7      0x27
  109.   KEY8      0x28
  110.   KEY9      0x29
  111.   AUTO      0x0B
  112.   MIX       0x0F
  113.   FTB       0x1F
  114.   KEY       0x49
  115.   KEYON     0x52
  116.   BKGD      0x48
  117.   TBAR      0x00
  118.   CLIP      0x0A
  119.